xwiki 文档迁移到 confluence-(0) 概述

本系列《xwiki 文档迁移到 confluence》主要记录了将 xwiki 文档同步迁移到 confluence 的过程.打算分为以下几个小节进行编写:

  • 迁移方案
    本节描述了 xwiki 文档迁移到 confluence 的方案.目前并没有现成解决方案, 那么该怎么做迁移, 本节描述了迁移过程中所涉及到的问题以及使用什么样的方案进行迁移, 能够让迁移方案既毕竟简单, 又能节省成本.
  • 遇到的坑及注意事项
    在迁移过程中免不了遇到一些问题, 本节就描述了迁移过程中遇到的坑(主要是 xwiki 相关的), 以及要注意的一些事项.
  • 如何将上传的 pdf 显示在 confluence 页面中
    上传 pdf 附件到 confluence 中很简单, 但是如何在页面中直接查看 pdf 文件, 而不是到附件中去查看上传的 pdf 文件, 本节描述了这个过程, 让上传的 pdf 可以直接在页面中进行查看.
  • Jackson 如何动态生成 key
    本节其实和此系列关系不大, 不过也是在这个过程中所遇到的问题, 所以也作为此系列的一节.我们知道 jackson 在序列化的时候可以根据字段名称或者注解来生成 key, 不过这些方式都是静态的.如何动态的生成 key, 本节提供了一种简单的解决方案可以达到此目的.
Swagger bug-当 http 请求方法是 get 时 Operation.getConsumes() 不应该返回 application/json
Swagger2Markup bug-生成的 html 文档有问题当 ApiModel value 包含斜线